home *** CD-ROM | disk | FTP | other *** search
/ MacWorld UK 2000 March / MW_UK_2000_03.iso / Shareware World / Utilities / Text Processing / Alpha / Help / Readme < prev    next >
Encoding:
Text File  |  1999-11-20  |  4.6 KB  |  86 lines  |  [TEXT/ALFA]
  1. Alpha version 7.2, using AlphaTcl library version 7.2.2
  2.  
  3. International users: select your keyboard in the international preferences 
  4. dialog (Config->Preferences->International) to ensure the menus contain 
  5. key-bindings suitable for your keyboard.  
  6.  
  7. Users of MacOS 8.5: the OS now 'captures' the Cmd-Tab key combination
  8. and uses it to switch applications. That combination is also used by
  9. default inside Alpha: you must either redefine Alpha's key-combination
  10. (Config->Special Keys…) or change the MacOS's key-combination.
  11.  
  12. For users upgrading from a version of Alpha older then 7.0 see the section
  13. "Upgrading from Alpha older than 7.0" below.
  14.  
  15. Alpha's documentation is currently a little out-of-date. It is undergoing a
  16. complete overhaul. To check on the status of that overhaul, or to download
  17. a pre-release version of the new documentation go to
  18. <http://www.theophys.kth.se/~jl/Alpha/newdocs.html>. 
  19. The main Manual (<- click to open) has now been updated. There is also a
  20. shorter Quick Start (<-- click on it!) document, and many other help files.
  21. You can access the help files under the system help menu. If you have
  22. recently updated Alpha you may wish to read the 'Changes' file.
  23.  
  24. Much of Alpha's functionality is implemented in 'packages' or 'extensions',
  25. and many additional packages are available to extend Alpha further. The
  26. 'Config->Preferences->Menus And Features' and 'Config->Mode Prefs->Menus
  27. and Features' menu items let you see which items are installed, and lets
  28. you turn them on and off. The 'Config->Packages' menu allows you to
  29. update modes, menus, and extensions quickly and easily by downloading small
  30. update files from the internet. However, most available package are bundled
  31. with Alpha. It is recommended that you try to learn the basics of Alpha
  32. before starting to download new packages. For those used to Emacs, a 'mode'
  33. in Alpha is like a 'major mode' in Emacs, an 'extension' or 'feature' in
  34. Alpha is like a 'minor mode' in Emacs.
  35.  
  36. See the file Packages for a list of pre-installed packages in Alpha.
  37.  
  38. Remember, Alpha has a Home Page, from which you can check for new versions 
  39. of Alpha, as well as the many modes and packages which have been written.  
  40. If you wish to download those things directly you can get them from 
  41. <ftp://alpha.olm.net/pub/packages/>, but Alpha contains menu items to allow 
  42. you to check for and/or download and install updated items automatically.  
  43. Many packages are also available from: <ftp://ftp.ucsd.edu/pub/alpha/> 
  44. (many thanks to UCSD for their generous donation of this ftp site).  If 
  45. you check both locations, Alpha will keep track of which contains the most 
  46. recent one for you.  For those from Europe, you may wish to try the mirror: 
  47. <ftp://anu.theologie.uni-halle.de/comp/mac/Alpha>
  48.  
  49. PLEASE use the Alpha-D mailing list to discuss problems, suggestions 
  50. etc with this release.  To subscribe, email <LISTSERV@LISTSERV.SYR.EDU> 
  51. and, in the text of your message (not the subject line), write: 
  52. 'SUBSCRIBE ALPHA-D'.  There are a number of known bugs which will hopefully
  53. be corrected in a future release.  PLEASE read the 'Bug Reports and Debugging' 
  54. file for a list of known bugs, and for how to give an informative bug 
  55. report, without which it is unlikely any bug you found can be fixed.
  56.  
  57. ===============================================================================
  58.  
  59. Upgrading from Alpha older than 7.0
  60.  
  61. Alpha stores most preferences in the 'defs.tcl' and 'arrdefs.tcl' files in 
  62. your preferences folder.  The preferences folder is in the standard system 
  63. preferences folder, and is named 'Alpha' (for versions < 7.0) or Alpha-v7
  64. for version 7 (and will be called Alpha-v8 when version 8.0 is released at 
  65. some point in the future...)
  66.  
  67. Some of your old preferences will be incompatible/irrelevant to the new 
  68. Alpha version when you upgrade from 6.x to 7.x therefore you shouldn't just 
  69. copy the two prefs files from one folder to the other.
  70.  
  71. Here's how to copy over just a few preferences: open the old 'defs.tcl' or 
  72. 'arrdefs.tcl' and examine them for lines you wish to copy.  Open the new 
  73. 'defs.tcl' and 'arrdefs.tcl'.  Alpha opens them in read-only mode, but you 
  74. can command-click on the 'lock' icon in the window to make the windows 
  75. modifiable.  Now copy and paste as you desire.  Finally save the windows and 
  76. quit and restart Alpha.  If you get an error on startup, you probably copied 
  77. over incompatible preferences and you'll have to delete the files and start 
  78. over (hence it may be a good idea to make a backup copy of the originals 
  79. before you start).
  80.  
  81. Note: if you don't wish to use a System-Folder prefs folder, create a folder
  82. called 'AlphaPrefs' next to the Alpha application.  Alpha will use that
  83. folder preferentially if it exists.
  84.  
  85.  
  86.